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PREFACE 

This supplement to the Model 990 Computer Prototyping System Operation Guide describes an 
enhancement of the TMS 9900 Prototyping System, defined as the Prototyping Monitor (PX) 
with Resident Assembler, Tracer, Linking Loader, and Editor (PXRATE). This supplement 
documents changes to the TMS 9900 software modules which now comprise the PXRATE 
system. It also describes the hardware required to support the PXRATE system. 

This manual is intended for users of the TMS 9900 Prototyping System software and for users 
who require the capability to generate, edit, assemble, load, and debug user application programs 
and generate firmware for the 990/4 Computer, the 990/10 Computer, and the TMS 9900 
Microprocessor. It is also intended for users who desire to perform input/output operations on 
the 733 ASR Data Terminal to/from peripheral devices. 

This manual is divided into four sections and one appendix as follows: 

I General Description — Describes the PXRATE software and the hardware needed to 
support it. 

II System Installation and Operation — Gives the sources of information on unpacking, 
installing, and operating the supporting hardware. Provides step-by-step procedures for 
PXRATE system software cassette generation. 

III Teletypewriter Input/Output Supervisor Calls — Describes the extension of I/O super- 
visor calls to include interface to the teletypewriter paper tape reader and punch. 

IV Demonstration of the PXRATE Software Package — Three sample programs are 
presented (numbers 3, 4, and 5). Sample program 3 illustrates the use of the PXRATE 
system in the development of a short user program. Sample program 4 demonstrates 
the use of supervisor I/O calls on the Model 33 ASR Data Terminal paper tape reader 
and paper tape punch. Sample program 5 demonstrates the use of the BNPF utility 
overlay with paper tape instead of magnetic tape cassette. 

A Paper Tape Reader/Punch File and Data Formats 

The following publications contain additional information needed to use the 990 Prototyping 
System. 


Title 


Part Number 


Model 990/4 Computer System Hardware 945251-9701 

Reference Manual 

Model 990 Computer TMS 9900 Microprocessor 943441-9701 

Assembly Language Programmer’s Guide 

Model 990 Computer Model 733 ASR/KSR Data 945259-9701 

Terminal Installation and Operation 
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SECTION I 

GENERAL DESCRIPTION 


1.1 INTRODUCTION 

This supplement to the Model 990 Computer Prototyping System Operation Guide documents an 
enhancement of the TMS 9900 Prototyping System, defined as the Prototyping Monitor (PX) 
with Resident Assembler, Tracer, Linking Loader, and Editor (PXRATE). This section presents 
an overview of the enhanced software and the hardware required to support it. The first portion 
of the section describes the purpose and capabilities of the enhanced software and identifies the 
hardware. The remainder of this section briefly describes changes to the modules that comprise 
the enhanced system software. These modules include the debug monitor and its overlays, the 
text editor, and the one-pass assembler. 

1.2 PURPOSE AND CAPABILITIES OF THE ENHANCED SYSTEM (PXRATE) 

The enhanced TMS 9900 Prototyping System software augments the capabilities of the TMS 
9900 Prototyping System software. The original system is documented in the Model 990 
Computer Prototyping System Operation Guide, Manual Number 945255-9701. User familiarity 
with the original system documentation and operation is prerequisite to this supplement. The 
PXRATE system requires a minimum memory size of 12K words. In this 12K, all software 
development/debug capabilities are coresident (text editor, assembler, linking loader, trace, and 
program debug). Coresidency of these capabilities negates the time-consuming process of reload- 
ing (from cassette) the appropriate utility between program development steps. This coresident 
package of software also supports the use of the Model 33 ASR Data Terminal paper tape 
reader/punch. 

1.2.1 DESCRIPTION OF SYSTEM ENHANCEMENTS. The purpose of the PXRATE proto- 
typing system software is to provide the capability to generate, edit, assemble, load, and debug 
user application programs and to generate firmware. The PXRATE package also includes a Device 
Service Routine (DSR) which supports the use of a TTY paper tape reader/punch. The former 
instruction trace overlay is no longer an overlay, but is now a command in the resident monitor. 
In addition to the debug functions, the debug monitor provides supervisor calls to perform 
input/output (I/O) operations on the 733 ASR Data Terminal and utility routines, such as 
decimal ASCII to binary, hexadecimal ASCII to binary, binary to decimal ASCII, and binary to 
hexadecimal ASCII conversion. Overlays to the debug monitor provide the capability to dump/ 
reload a program from/to memory to/from tape in a compressed absolute format. In addition, 
monitor overlays are provided to support the PROM Programmer Package and BNPF (or 
HIGH/LOW) formatted dumps to cassette tape or to paper tape. The BNPF overlay also provides 
the capability to load tape in BNPF format back into memory. 

The PXRATE system software is available in object format on a read-only magnetic tape cassette 
and in source format on punched cards; however, the system source must be assembled and 
linked using a 990/10 Program Development System. The PXRATE system software provides the 
capability to generate source and object which is upward compatible with other 990 systems. See 
Appendix A of Model 990 Computer Prototyping System Operation Guide for restrictions. 
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1.2.2 HARDWARE CONFIGURATION REQUIRED FOR PXRATE SYSTEM SOFTWARE. The 
hardware required for the PXRATE prototyping system is the same as that described in the 
Prototyping System Manual except that a minimum of 12K words of memory is required in the 
enhanced system. See figures 1-1 through 1-4 for detailed memory requirements of systems with 
12, 16, 20, and 24K words of memory. Part of the user area of the memory is shared by the 
text editor and the one-pass assembler for tables and buffer space. 

The Model 33 ASR teletypewriter may be configured as an optional peripheral (TTY/EIA Kit, 
Part Number 974704-0002). It may not be used as the system console. The interface card must 
be inserted in the left half of computer chassis slot 6, corresponding to CRU base address 20 16 . 

1.3 SYSTEM PART NUMBERS 

Refer to Manual Number 945255-9701, paragraph 1.3, page 1-5. 

1.4 SOFTWARE MODULES 

In the PXRATE prototyping system, the debug monitor, trace capability, text editor and the 
one-pass assembler have been combined into one module. In addition, when PXRATE is initially 
loaded, the linking loader overlay is automatically placed in the overlay area. This software 
package now becomes coresident in memory. The instruction trace overlay now becomes a part 
of the monitor and is no longer an overlay. The PXRATE package is supplied on cassette tape. 
Two new commands now reside in the coresident package. These commands are PA to activate 
the one-pass assembler, and TE to activate the text editor. No parameters are necessary for either 
command. Following the invocation of either of these commands, the operation of the assembler 
or text editor is the same as described in Section IV of the Prototyping System Manual. 
Activation and operation of the trace and linking loader has not been altered, except that no 
overlay process is required prior to their use. Since the linking loader is located in the monitor 
overlay area, it will be overwritten if another overlay is placed in memory, and must be reloaded 
to be used again. 
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BYTE ADDRESSES 
DEC. HEX. | 

°1 0 °1 6 


128 80 , 


10,818 2A4 2 


23,786 5CEA 


31 ,054 794E 


32,766 7FFE 



INTERRUPT AND XOP 

TRANSFER VECTORS - 64 WORDS, 


AVAILABLE USER AREA 
(5345 | 0 WORDS) 


ASSEMBLER 


TEXT 

EDITOR 


ENTRY POINT 


MONITOR 


TRANSIENT 
AREA FOR 
OVERLAYS 


PXRATE SYSTEM 


(A)l 34538 


note: LINKING LOADER OVERLAY IS AUTOMATICALLY 

LOADED IN OVERLAY AREA WHEN PXRATE CASSETTE 
IS LOADED . 


Figure 1-2. 16K Hardware Memory Configuration 


Digital Systems Division 


946243-9701 



BYTE ADDRESSES 20K 



note: 


LINKING LOADER OVERLAY IS AUTOMATICALLY LOADED IN 
OVERLAY AREA WHEN PXRATE CASSETTE IS LOADED. 


(A )1 34539 


Figure 1-3. 20K Hardware Memory Configuration 
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BYTE ADDRESSES 


24K 


DEC. 
°1 0 


1 28 


27 ,202 


40,170 


47 ,438 


49,150 



NOTE. 


LINKING LOADER OVERLAY IS AUTOMATICALLY 
\- oadedi ^ overlay AREA WHEN PXRATE CASSETTE 


(A)l 34540 


Figure 1-4. 24K Hardware Memory Configuration 
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SECTION II 


SYSTEM INSTALLATION AND OPERATION 


2.1 INTRODUCTION 

Refer to Manual Number 945255-9701, Section II, paragraph 2.1, page 2-1. 

2.2 UNPACKING AND INSTALLATION OF HARDWARE 

Refer to Manual Number 945255-9701, Section II, paragraph 2.2, page 2-1. 

2.3 HARDWARE OPERATION 

Refer to Manual Number 945255-9701, Section II, paragraph 2.3, page 2-3. 

2.4 PXRATE SYSTEM SOFTWARE CASSETTE GENERATION 

Absolute versions of the PXRATE package are supplied for each memory configuration. The 
PXRATE prototyping system kit includes two cassettes containing 13 files total. The files are 
arranged as shown in table 2-1. 

Note that absolute code versions of PXRATE are supplied for all of the available memory 
configurations, saving the user from having to create them during installation. There is one set of 
overlays in relocatable object format, which can be used with any of the versions of PXRATE. 

Paragraphs 2.4.1 and 2.4.2 detail the procedures used to create a bootstrap tape cassette of the 
PXRATE monitor and individual cassettes for each overlay. 


Table 2-1. PXRATE System Software Cassettes 
PXRATE Cassette 1 of 2 


Side A 

1. Upfront Loader 

2. Absolute Code Version of PXRATE 
for 12K Machine 

3. Absolute Code for 16K Machine 

PXRATE 

Side A 

1. Linking Loader Overlay 

2. Absolute Dump/Load Overlay 

3. PROM Programmers, Part 1 

4. PROM Programmers, Part 2 

5. BNPF Dump Overlay 

6. HIGH/LOW DUMP Overlay 


Side B 

1. Upfront Loader 

2. Absolute Code Version of PXRATE 
for 20K Machine 

3. Absolute Code for 24K Machine 
te 2 of 2 

Side B 

1 . Relocatable Code Version of PXRATE 
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2.4.1 PROCEDURE FOR MAKING CASSETTE FOR MONITOR FROM PXRATE MASTER. 

For the convenience of the user, the text of the following procedure is keyed by parenthetical 
numbers to the 733 ASR panel switches illustrated in figure 2-1. 


1. Turn on power to the 733 ASR Data Terminal. 

2. On the ASR panel: 


a. Set KEYBOARD (1) to OFF. 

b. Set PLAYBACK (2) to LOCAL. 

c. Set RECORD (3) to LOCAL. 

d. Set PRINTER (4) to OFF. 

e. Set CASSETTE 1 to PLAYBACK (10); CASSETTE 2 will be in RECORD. 

3. Before inserting a tape cassette into a transport, check the status of the write tabs on 
the bottom of the tape. If the tape is to be written on, the tab for the side of the tape 
to be written on should cover the hole in the cassette case; if it is a read-only tape, the 
tab should not cover the hole. Holding a tape cassette in front of you with the tape 
side up, the write tab for that side of the tape will be on the bottom right of the tape 
cassette. See figure 2-2. 

4. Select the side of PXRATE cassette 1 that is specified in table 2-1 for computer 
memory size. Insert into cassette 1 transport. 

a. Open the cassette 1 transport door. 

b. Insert the tape cassette with the tape side up as shown in figure 2-3. 


CASSETTE 1 


CASSETTE 2 


REWIND LOAD/FF 


wmrr 


RECORD 

READY 

END 


READY 

END 


REWIND LOAD/FF 


Tinrr 


PLAYBACK CONTROL 

CONT BLOCK CHAR 

START FWD FWD ON 


RECORD CONTROL 


CHARACTER 


<8 




TAPE FORMAT 


LOCAL _____ 

KEYBOARD PLAYBACK 


LOCAL 

RECORD PRINTER 


(A)134541 


Figure 2-1. 733 ASR Panel 
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Figure 2-2. Tape Cassette Write Tabs 



(A) 1 34543 


Figure 2-3. Tape Cassette Installation 


c. Press the tape cassette down and in, being sure that the capstan and reel rotors fit 
into the proper holes. 

d. Close the cassette transport door. 

5. Insert the copy tape cassette side A into the cassette 2 transport, and: 

a. Set RECORD CONTROL to OFF (5). 

b. Set CASSETTE 1 to REWIND (6). 

c. When the END lamp lights, press LOAD/FF (7). The READY lamp should light 
after a few seconds. 

d. Set CASSETTE 2 to REWIND (8). 
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e. When the END lamp lights, press LOAD/FF (9). The READY lamp should light 


after a few seconds. 

f. Set RECORD CONTROL to ON (1 1). The ON lamp should light. 

g. Set TAPE FORMAT (12) to LINE. 

h. Press CONT START (13) to begin high-speed tape duplication. The upfront loader 
file will be recorded from cassette 1 to cassette 2 (original tape to copy tape) 
when the CHARACTER lamps stop flashing. 

NOTE 

To stop the duplication process at any point, press 
(CONT) STOP. 

i. Set RECORD CONTROL to OFF (5). This clears the buffer and records the last 
block of data on the tape. 

6. If the desired version of PXRATE cassette 1 is the second file (see table 2-1), skip 
step 6.a and continue with step 6.b. 

a. Press CONT START (13) to read through the second file. This brings the third 
file into position for recording. 

b. Set RECORD CONTROL to ON (1 1). 

c. Press CONT START (13) to record the monitor to the copy cassette. When the 
CHARACTER lamps stop flashing, recording is complete. 

d. Set RECORD CONTROL to OFF (5). 

e. Set CASSETTES 1 and 2 to REWIND (6) (8). 

7. Remove PXRATE cassette 1 and store in a safe place. 

8. Remove copy cassette and label it “PXRATE BOOTSTRAP TAPE”. Adjust write tab 
on bottom of tape to uncover hole for side A of tape (see step 3 and figure 2-2). This 
protects tape side A from being accidentally overwritten. The tape is now ready for 
use. 

9. For loading the PXRATE tape, refer to paragraph 2.5.1 of the Prototyping System 
Manual. 

2.4.2 PROCEDURE FOR MAKING CASSETTES FOR OVERLAYS. The user should copy each 
of the overlay object files to a separate cassette for convenience in using the system. The 
following procedure should be used. The text of this procedure is keyed by parenthetical 
numbers to the 733 ASR panel switches illustrated in figure 2-1. 

1. Select side A of PXRATE cassette 2, and insert into cassette drive 1. Insert a blank 
cassette, side A, into cassette drive 2. Rewind and ready both tapes. File 1 is now ready 
for recording (see table 2-1). 

2. Set RECORD CONTROL to ON ( 1 1 ). 
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3. Press CONT START (13). This causes the selected file to be recorded on the copy 
cassette. 


4. After copying the PROM Programmer part 1 , repeat step 4 to record the next file (PROM 
Programmer part 2) onto the same cassette. Do NOT turn RECORD CONTROL to OFF 
between these two files. 

5. Set RECORD CONTROL to OFF (5) to clear the buffer and record the last block of data 
on the tape. 

6. Rewind and remove the copy cassette and label with the appropriate file name. Protect 
tape side A from overwrite by setting write tab to uncover hole on bottom of tape for 
side A (see figure 2-2). 

7. If there are any remaining overlay object files on PXRATE cassette 2, insert a blank 
cassette into cassette drive 2. Rewind and ready blank cassette and repeat steps 2 through 
6 (note that step 4 applies only to the PROM Programmer overlay). Continue this process 
until each overlay is recorded on a separate cassette. 

8. Rewind and remove PXRATE cassette 2 and store it in a safe place. 

The relocatable code version of PXRATE (table 2-1, cassette 2 side B) is supplied in the event 
that the user would like to “custom place” the monitor in memory. The user must affix the 
appropriate D-tag to the beginning of the relocatable version (see the example on page 2-5 of the 
Prototyping System Manual for details). 

Relevant Data: 

Length of monitor (including editor 

and assembler, but not including 

overlay area) = 4FOC 16 bytes 

Length of longest overlay = 6B0 16 bytes 

Monitor entry point = D-tag value + 32A8 16 bytes 


CAUTION 

It is possible for the user to overwrite the assembler, text editor, 
and monitor by loading a user program larger than the available 
user space (see figures 1-1 through 1-4). If this should happen, 
reload the entire PXRATE package from the cassette tape. 
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SECTION III 

TELETYPEWRITER INPUT/OUTPUT (I/O) SUPERVISOR CALLS 


3.1 INTRODUCTION 

This section describes the extension of prototyping system I/O supervisor calls to include 
program I/O interface to the teletypewriter paper tape reader and punch (part of the Model 33 
ASR Data Terminal). The user is referred to paragraph 3.5 of the Prototyping System Manual for 
a general description of supervisor I/O calls. Read and write supervisor call codes are consistent 
with those of the rest of the prototyping system. 

3.1.1 HARDWARE (MODEL 33 ASR DATA TERMINAL). The Model 33 ASR Data Terminal 
is an automatic send/receive teletypewriter. It has a paper tape reader and punch for automatic 
input and output. The reader is a means of automatically entering programs that are on punched 
paper tape. The punch is a means of recording object code output of the computer on paper 
tape. File data of other types may be read or punched in a similar manner. The reader may be 
put online for input, and the punch may be put online for output. 

NOTE 

The Model 33 ASR Data Terminal is supported as an optional 
peripheral only. It may not be configured as the system console in 
place of the 733 ASR terminal. 

Data is punched on paper tape serially by character. The individual bits of each character are 
aligned across the width of the tape and are punched in parallel. The hole in the tape represents 
a one bit and the absence of a hole represents a zero bit. Data is transmitted and received 
simultaneously (full duplex) over current loops in 7-bit ASCII for textual character or 8-bit code 
for direct mode. The Model 33 ASR requires a Teletypewriter Peripheral Kit (ASR 3320/5JE 
Interface), TI Part Number 974704-0002, which is supported by the computer CRU DSR and 
I/O supervisor calls. 

3.1.2 REFERENCES. For further information, refer to TTY/EIA Interface Module Installation 
and Operation Instruction Manual, Section II, TI Part Number 946240-9701. A complete descrip- 
tion of the Model 33 ASR may be found in Technical Manual, 33 Teletypewriter Sets, Volumes 
1 and 2 (Bulletin 31 0B) and Model 33 Page Printer Parts (Bulletin 1 1 84B) supplied with the 
teletypewriter. If your teletypewriter was not supplied by Texas Instruments, modifications are 
necessary as outlined in the above referenced TTY/EIA Interface Module Installation and 
Operation Instruction Manual. 

3.2 ACCESS TO MODEL 33 ASR DATA TERMINAL 

The PXRATE system accesses the TTY paper tape reader/punch by the invocation of supervisor 
calls. A supervisor call is made with an extended operation (XOP) assembly language machine 
instruction using an extended operation code of 15. The XOP instruction specifies an address 
pointing to a Physical Record Block (PRB) containing the supervisor call and any necessary 
arguments. The format of the PRB is illustrated in figure 3-1. 

A detailed discussion of the PRB parameters is presented in paragraph 3.5.2 of the Prototyping 
System Manual. 
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0 1ST BYTE 7 8 2ND BYTE 15 



Figure 3-1. Format of Physical Record Block 

3.3 LOGICAL UNIT NUMBER (LUNO) ASSIGNMENT 

Before execution of any supervisor call I/O operation, a LUNO must be assigned to the 
particular peripheral device with which I/O communication is desired (refer to paragraph 3.4.2 of 
the Prototyping System Manual). 

With the Model 33 ASR Data Terminal, the device symbols and names of interest are: 

PTR Paper Tape Reader 

PTP Paper Tape Punch 

An example of LUNO assignment is: 

,AL,3,PTR 

This assigns Logical Unit Number 3 to the paper tape reader, so that whenever LUNO 3 appears 
in a PRB, the paper tape reader will be accessed through the execution of a supervisor I/O 
operation. It should be noted that default LUNOs have not been provided for Model 33 ASR 
Data Terminal support (refer to paragraph 3.4.2 of the Prototyping System Manual). 

3.4 OPERATION CODE (OPCODE) INTERPRETATION 

The monitor’s interpretation of the various opcodes in the PRB depend upon the particular 
teletypewriter device being accessed. The following two paragraphs describe those interpreta- 
tions. 

3.4.1 PAPER TAPE READER. The functions of the possible opcodes for the tape reader are 
described in table 3-1. 

3.4.2 PAPER TAPE PUNCH. The functions of the possible opcodes for the tape punch are 
described in table 3-2. 

3.5 ERROR RETURNS 

Error detection is performed by the Device Service Routine (DSR) with meanings as defined in 
table 3-3. 

When a supervisor call causes one of these errors to occur, the code is returned in the user flags 
byte of the PRB (see figure 3-1). 
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Table 3-1 . Functions of Opcode for Tape Reader 


Hexadecimal 
I/O Opcode 

Name 

Function 

00 

Open 

Sets reader flag so data can be read from device, error 3* if already 
opened. 

01 

Close 

Resets reader flag. 

02 

Close EOF 

Error 2* 

03 

Open Rewind 

Same as Open 

04 

Close Unload 

Same as Close 

05 

Read Status 

Ignored 

06 

Forward Space 

Ignored 

07 

Backspace 

Ignored 

08 

FMP 

Ignored 

09 

Read ASCII 

If reader flag is set, data is read from the paper tape. Termination 
is caused either by a carriage return or user’s buffer full. Only seven 
bits of data are transferred to the user’s buffer with the eighth bit 
(parity) ignored. At termination the tape continues until a reader- 
off character is sensed, during which no data is stored. The number 
of characters read is returned to the user’s character count. 

A 

Read Direct 

Checks if reader flag is set. If set, data is read until the first non-null 
frame is encountered. Termination is caused by user’s buffer full, 
and tape continues to pass until a reader-off is sensed during which 
no data is stored. The number of characters read is returned to the 
user’s character count. 

B 

Write ASCII 

Error 2* 

C 

Write Direct 

Error 2* 

D 

Write EOF 

Error 2* 


*See table 3-3 for error meanings. 

3.6 PAPER TAPE FILE AND DATA FORMATS 

Two types of paper tape I/O are supported: ASCII and Direct. The type of data to be punched 
or the interpretation of the data to be read depends on the particular type of opcode used (see 
Opcode Interpretation, paragraph 3.4). 

3.6.1 ASCII. This type of data represents characters in ASCII 7-bit code. ASCII mode is used 
for storing and retrieving character information. The ASCII paper tape format and an actual 
paper tape sample are illustrated in figure 3-2. 
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Table 3-2. Functions of Opcode for Tape Punch 


Hexadecimal 
I/O Opcode 

Name 

Function 

00 

Open 

Sets write flag so data can be punched to device, error 3* if already 
opened. 

01 

Close 

Resets write flag. 

02 

Close EOF 

Resets write flag and punches ASCII EOF, and 80 null frames. 

03 

Open Rewind 

Same as Open and punches 80 null frames. 

04 

Close Unload 

Same as Close operation 

05 

Read Status 

Ignored 

06 

Forward Space 

Ignored 

07 

Backspace 

Ignored 

08 

FMP 

Ignored 

09 

Read ASCII 

Error 2* 

A 

Read Direct 

Error 2* 

B 

Write ASCII 

Checks if write flag is set. If set, data is punched to the paper tape 
specified by the user’s PRB, where word 6 tells the number of char- 
acters and word 4 tells the address of characters to be punched. Only 
seven bits of data are punched where the eighth bit (parity) is always 
zero. Termination is caused by end of character count, and then an 
ASCII EOR is punched. 

C 

Write Direct 

Checks if write flag is set. If set, punches the specified number of 
characters and Direct EOR. 

D 

Write EOF 

If write flag is set, punches ASCII end of file. 

E 

Rewind 

Ignored 

F 

Unload 

Ignored 


*See table 3-3 for error meanings. 

3.6.2 DIRECT. This is an 8-bit code in which straight 8-bit binary values are represented on 
tape. A hole represents a one bit and lack of a hole represents a zero bit. It is used for storing 
and retrieving binary data on paper tape. The Direct paper tape format and an actual paper tape 
sample are illustrated in figure 3-3. 

For additional information regarding the ASR 33 Data Terminal paper tape reader and paper 
tape punch file and data formats, see Appendix A of this supplement. 
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Table 3-3. Error Code Functions 
Error Code F unction 

(Illegal opcode 


Device already open 
Device not open 


ASCII FORMAT 


BEGINNING 
OF TAPE * 


BLANKS 

ASCII 

EOR 

ASCII 

// 

EOR . . • EOR 

ASCII 

EOF 

BLANKS 


DATA 


DATA 


DATA 



END OF 
TAPE 


BLANKS : 
EOR : 

EOF : 


80 NULL CHARACTERS 

CR , LF, DC 3 , NULL, NULL, NULL, NULL 
DC3 , CR , LF, DC 3 , NULL, NULL, NULL 


(A)1 34545 



0 10 1 0 0 1 1 = S 


Figure 3-2. ASCII Paper Tape Format with Sample Paper Tape 
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DIRECT FORMAT 


BEGINNING 
OF TAPE 1 


BLANKS 

DIRECT 

EOR . 

-*/ 

• • DIRECT 

EOR 

BLANKS 


DATA 


DATA 




BLANKS: 80 NULL CHARACTERS 

EOR; DC3 , NULL, NULL, NULL 



(A)l 34546 


0 0 0 1 110 1 = > 1 D 


Figure 3-3. Direct Paper Tape Format with Sample Paper Tape 


END OF 
TAPE 
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SECTION IV 

DEMONSTRATION OF THE PXRATE SOFTWARE PACKAGE 


4.1 SAMPLE PROGRAMS 

Sample programs 1 and 2 exist in the Prototyping System Manual. These programs may be used 
with the PXRATE system. A minimum of 4K-word user memory space is required with sample 
program 2. Therefore, at least a 1 6K-word memory prototyping system is required for sample 
program 2. 

Three new sample programs (numbers 3, 4, and 5) are presented in this section. Sample 
program 3 illustrates the use of the PXRATE system in the development of a short user program. 
Sample program 4 demonstrates the use of supervisor I/O calls on the Model 33 ASR Data 
Terminal paper tape reader and paper tape punch. Sample program 5 demonstrates the use of the 
BNPF utility overlay with paper tape instead of magnetic tape cassette. 

These sample programs are presented with the assumption that the user has read the Prototyping 
System Manual and this supplement to the manual, and has been introduced to the functions 
used in these documents. 

The source for sample programs 3 and 4 are provided on tape cassette; sample program 5 
requires only the BNPF overlay. 

Included in each of the following sample programs is a brief explanation of the procedure and a 
listing of most, if not all, of the actual procedures followed. In some places, comments have 
been added within computer printout reproductions. The following conventions are used in each 
of the sample program listings: 

• Comments that explain to the user what to do or what is happening are delineated by 
parentheses. 

• Keys that must be depressed on the log keyboard are indicated in the listings by an 
underscore. 

• Angled brackets enclose a single key to be depressed; e.g., (<CR>) directs the user to 
depress the carriage return. 

4.1.1 SAMPLE PROGRAM 3, USER PROGRAM DEVELOPMENT. This program demonstrates 
the use of the PXRATE system in the development of a user program. The source for this 
program is supplied to the user on a cassette. The program takes a string of ASCII digits and, 
given the radix, computes the binary value of the number. An intentional error has been 
introduced into the program to demonstrate use of the PXRATE system to detect, locate, and 
correct programming errors. 

4.1.2 TEXT EDITOR. The user should ready the sample program cassette in the cassette 1 
transport of the 733 ASR Data Terminal and ready a blank cassette in the cassette 2 transport. 
Now some comments are added to the source by means of the text editor. See figure 4-1. 
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CEBIT THE SDURCE PROGRAM) 
■IE <<CR>> 

PXREDT 948927 ♦♦ 12JUL76 
POSITION TAPES* ENTER CR 

<<CR> > 

7 D50 . 

END OF FILE 

? T <<CR» 


?P 50 

C<CR> 

> 


0001 


IDT 'BASCON' 


0002 

♦ 



0003 

♦ 

THIS PROGRAM TAKES AN 

ASCII NUMBER AND 

0004 

♦ 

CONVERTS IT TO A SPECIFIC BASE IN 2'S 

0005 

♦ 

COMPLEMENT NOTATION. 

THE POSITIVE 

0 0 06 

♦ 

NUMBER MUST BE IN 7-BIT fiSCII FORMAT 

0007 

♦ 

STARTING AT LOCATION < 

INDEPENDENT DF PROGRAM 

0008 

♦ 

BASE ADDRESS? >104. ONE DIGIT PER BYTE. 

0009 

♦ 

THE BASE VALUE SHOULD 

BE A DATA WORD AT 

0010 

♦ 

LOCATION >1005 THE LENGTH DF THE NUMBER 

0011 

♦ 

TO BE CONVERTED? IN DIGITS? SHOULD BE AT 

0 0 1 2 

♦ 

DATA LOCATION >102. 


0013 

♦ 

THE RESULT IS RETURNED 

AT LOCATION >120. 

0014 

♦ 

NO ASCII VALIDITY CHECKS OR OVERFLOW CHECKS 

0015 

♦ 

ARE MADE. 


0 016 

♦ 



0 0 1 7 

ENTRY 

LWPI WRKS 


0 0 1 8 


CLR R2 

R2=LD0P COUNTER 

0 0 1 9 


CLR R3 

R3= INTERMEDIATE ACCUMULATOR 

0020 

LOOP 

M P Y © B A S E ? R 3 

MULT. SUBRESULT BY BASE 

0021 


MOV R4?R3 

LOAD LEAST SIG. BITS OF RESI 

0022 


MOVE ©NUMBER '•R2> ? R4 


0023 


SRL R4?8 


0024 


A R4?R3 

ADD NEXT DIGIT 

0025 


A I R3 ? -3 0 


0026 


INC R2 


0027 


C R2? ©LENGTH 


0028 


•JNE LOOP 

JUMP BACK IF NOT DONE 

0029 

MOV 

MOV R3? ©RESULT 


0 03 0 


XOP ©OUT ? 15 



0031 

AORG >100 

0032 BASE 

DATA >10 

0033 LENGTH 

DATA >6 

0034 NUMBER 

BSS > 1 0 

0035 

AORG >120 

0036 RESULT 

DATA 0 

0037 WRKS 

BSS >20 

0038 OUT 

DATA >0400 

0 039 

END ENTRY 

LAST LINE 


? 


134547 ( 1 / 2 ) 



Figure 4-1. Edit the Source Program (Sheet 1 of 2) 
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<RDD SOME COMMENT LINES TO THE SOURCE) 

? D3 Q . < <CR> ) 

?JP < <CR> > 

0031 AORG >100 

?U * // 

?P n 

0 030 XOP 50UT j 1 5 

?C // 

XOP 5>OUT>15 RETURN TO MONITOR < CONTROL- 1 S USED FDR TABS) 

( < CR > f < CR> 

?T_ < <CR>> 

? D31 // 

?P // 

0031 fiDRG >100 

7_I_ // 

♦ DATA STORAGE RRER 

< <CR> !» <CR> > 

?T_ <<CR>>, 

? D£9 // 

?P6 a 

XDR JOUT ;• 1 5 RETURN TO MONITOR 

0031 flDRG >100 

♦ 

♦ DRTR STDRRGE RRER 

♦ 

0033 ERSE DRTR >10 

?£ «££>> 

END EDIT 

TERM I NRTE -‘CONT I NUE'TT <<CR>> 

■::HIT CRECORD CONTROL OFF> SWITCH TO PUT RN EOF ON TRPE > 


(A) I 3 4547 (2/2) 


Figure 4-1. Edit the Source Program (Sheet 2 of 2) 


The edited source program is recorded on the blank cassette by the PXRATE text editor. Now, 
remove the sample program cassette from the cassette 1 transport. 

4.1.3 ONE-PASS ASSEMBLER. In order to assemble the program, the edited source cassette 
(which has just been recorded) should be readied in the cassette 1 transport with a blank cassette 
in the cassette 2 transport to accept the object code. Follow the procedure as demonstrated in 
figure 4-2, recording the object code on the blank cassette in the cassette 2 transport. 
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. (ASSEMBLE THE PROGRAM) 

■ PA <<CR>) 

PXRASM 948925 ♦♦ 12JUL76 
PREDEFINED REGISTERS? Y (<CR>> 

ASM/TERM? A_ (<CR>> 


PAGE 0001 


0001 




IDT 

■••BASCON-' 

0002 



♦ 



0003 



♦ 

THIS 

PROGRAM TAKES AN ASCII NUMBER AND 

0004 



♦ 

CONVERTS IT TO A SPECIFIC BASE IN 2 y S 

0005 



♦ 

COMPLEMENT NOTATION. THE POSITIVE 

0006 



♦ 

NUMBER MUST BE IN 7-BIT ASCII FORMAT 

0007 



♦ 

STARTING AT LOCATION (INDEPENDENT OF PROGRAM 

0008 



♦ 

BASE 

ADDRESS) >104? ONE DIGIT PER BYTE. 

0009 



♦ 

THE BASE VALUE SHOULD BE A DATA WORD AT 

0010 



♦ 

LOCATION >1005 THE LENGTH OF THE NUMBER 

001 1 



♦ 

TO BE CONVERTED!. IN DIGITS? SHOULD BE AT 

0012 



♦ 

DATA 

LOCATION >102. 

0013 



♦ 

THE RESULT IS RETURNED AT LOCATION >120. 

0014 



♦ 

NO ASCII VALIDITY CHECKS DR OVERFLOW CHECKS 

0015 



♦ 

ARE MADE. 

0016 



♦ 



0017 

0000 

02E 0 

ENTRY 

LWP I 

WRKS 


0002 

— 




0018 

0004 

04C2 


CLR 

R2 R2=L00P COUNTER 

0019 

0006 

04C3 


CLR 

R3 R3= INTERMEDIATE ACCUMULATOR 

0020 

0008 

38E0 

LOOP 

MPY 

S'BASE? R3 MULT. SUBRESULT BY BASE 


00 0A 

— 




0021 

OOOC 

C0C4 


MOV 

R4?R3 LOAD LEAST SIG. BITS OF RESULT 

0022 

000E 

D122 


MOVE 

9NUMBER (R2) ? R4 


0010 

— 




0023 

0012 

0984 


SRL 

R4? 8 

0024 

0014 

A0C4 


A 

R4?R3 ADD NEXT DIGIT 

0025 

0016 

0223 


A I 

R3? -30 


0018 

FFE2 




0026 

0 0 1 A 

0582 


INC 

R2 

0027 

00 1C 

8802 


C 

R2? 9LENGTH 


0 0 1 E 

— 




0028 

0020 

16F3 


•JNE 

LOOP JUMP BACK IF NOT DONE 

0029 

0022 

C803 

MOV 

MOV 

R3? ©RESULT 


0024 

— 




0030 

0026 

2FE0 


XOP 

©OUT ? 15 RETURN TO MONITOR 


0028 

— 




0031 

0100 



AORG 

>100 

0032 



♦ 



0 033 



♦ DATA 

STORAGE AREA 

0034 



♦ 



0035 

0100 

0010 

BASE 

DATA 

> 1 0 


OOOA^OIOO 




0036 

0102 

0 0 06 

LENGTH 

DATA 

>6 


OOIE^OIO 2 




0037 

0104 


NUMBER 

BSS 

>10 


001 0^01 04 




0038 

0120 



AORG 

>120 

0039 

0120 

0000 

RESULT 

DATA 

0 


0024^ 01 20 




004 0 

0122 


WRKS 

BSS 

>20 


00 02^ 01 22 




0041 

0142 

0400 

□IJT 

DATA 

>0400 


0028^0142 




0042 




END 

ENTRY 


0000 ERRORS 
ASM/TERM? T_ <<CR>> 

. (HIT < RECORD CONTROL OFF> SWITCH) 
(A)1 34548 


Figure 4-2. Assemble the Program 
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4.1.4 LOAD UPDATED PROGRAM AND EXECUTE. Move the object cassette from cassette 2 
transport to the cassette 1 transport in order to load the object code (figure 4-3). (Alternately, 
the cassette could be kept in the cassette 2 transport, the RECORD/PLAYBACK switch set to 
PLAYBACK from it, and the LP command below modified to LP, 8. See paragraph 3.4.5 of the 
Prototyping System Manual.) 

After a trial execution, as demonstrated in figure 4-3, the result shown in address 120 16 is incorrect. 

4.1.5 PROGRAM TRACE. Using the trace capability of the PXRATE system, the user can 
single step through program execution, using the space bar to advance to the next instruction 
(figure 4-4). 

At this point, the program trace has been stopped by means of the escape key, since an error is 
indicated by the last line of trace corresponding to the instruction found at line 25 at the 
program (AI R3, -30). It was intended to subtract 30 from R3; however, it must be hexa- 
decimal 30, not decimal 30. The easiest method of correction for this single error is to patch 
memory location 1 8 16 value FFE2 16 , which actually resides in memory at B8 16 because of the 
A0 16 offset from the load command. The new value for 18 16 should be FFD0 16 = -30 16 . 

4.1.6 PATCH AND EXECUTE PROGRAM, VERIFY RESULTS. The patch is made, the 
program executed, and the results verified (figure 4-5). 

This is the correct result since E 16 is 14 10 or 32 4 . If the user wishes, a permanent fix may be 
made by changing “AI R3, -30” to AI R3, ->30” in the source using the text editor. 

4.2 SAMPLE PROGRAM 4, PAPER TAPE UNIT DEMONSTRATION USING I/O 
SUPERVISOR CALLS 

The general flow of the program to demonstrate paper tape outputs an initial prompt that 
expects one of three possible inputs; all other inputs cause the initial prompt to be output again. 
The three inputs are: E, to demonstrate error codes; O, to demonstrate reads and writes; and S, 
to return to the monitor. If the E or O options are taken, another prompt is output which 
expects an opcode followed by a mode type (R for reader and P for punch). The opcode is 


(LOAD UPDATED PROGRAM} 

.LP ( <CR> } 

(SET UP SOME TRIAL INPUT j TO CONVERT "3£"' IN BASE 4 TO BINARY) 
. MM- 1 00 <<CR>> 

0100=0010 ± (HIT ( SPACE BAR) TO MODIFY NEXT LOCATION) 

01 02=0006 _£ // 

0104=3322 3332 (HIT <CR>) 

.EX «CR» 


(THE PROGRAM SHOULD HAVE EXECUTED? WE NOW EXAMINE THE RESULTS) 
■ III: tso «CR» 

0 1 c! U- U 06S 

< WRONG! ! ) 


(A) 1 34549 


Figure 4-3. Load Updated Program 
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CEXECUTE 


PROGRAM UNDER TRACE) 


. ST ? 0 ? PSEBADEB A < <CR > ) 
. SR ? 0 ? A 0 ? FF ? Q ? S ( < CR :» 
.MR < <GR>) 


PC= 00A0 << 

SPACE BAR 

>) 




WP=01 

££ 0 






ST =00 00 0 

ii 





. RU 

<<CR>> 






00 A0 

SE=000 0 

SB=007£ 

SA = 0 07£ 

•CHIT <SPfiCE BflR> 

FOR EACH N 

0 0A4 

SE=01£6 

SB = 0 0 0£ 

SA= 0 0 0 0 




0 0A6 

SE= 0 1 £8 

SB = 0 068 

SA=0000 




00 AS 

SE= 0 1 0 0 

SB 55 00 04 

SA-0004 

DE = 0 1£8 

DB= 0 0 0 0 

DA=0000 


0 1 £A= 0 0 0 

0 





0 0AC 

SE=01£A 

SB= 0 0 0 0 

SA = 0 0 0 0 

DE= 0 1 £8 

D B = 0 0 0 0 

DA = 0 0 0 0 

00AE 

SE=01 04 

SB =3338 

SA=333£ 

DE=0-1£A 

DB= 0 0 0 0 

DA =33 0 0 

00B£ 

SE= 0 1 £ A 

SB =33 0 0 

SA = 0 033 




00B4 

SE= 0 1 £ A 

SB=0033 

SA= 0 033 

DE=01£8 

DB= 0 0 0 0 

DA = 0 033 

0QB6 

SE=01£8 

SB = 0 033 

SA= 0 0 1 5 





<AHAAA! S — HIT <ESC» 


(A) 1 345 50 

Figure 4-4. Execute Program Under Trace 

<PATCH AND EXECUTE PROGRAM? THEN VERIFY THE RESULTS) 

. IM? 1 OQ, 1Q4 < <CR> > 

0 1 0 0 = 0 0 0 4 0 0 0 £ 3 3 3 £ 


(TO PATCH ASSEMBLY LISTING LOCATION >18? WE MUST ADD THE PROGRAM LOAD BIAS) 
. HA? 18? AO <<CR>) 

SUM= 0 OB 8 0 0 1 84 D I FF=FF78 - 0 0 1 36 

. MM? B8 <<CR>) 

0 0B8=FFE£ FFD U 
. MR (. < C R ) 

PC=OOBA ftO «CR» 

. EX «CR» 

. IM? 1 £ 0 «CR>) 

01 £0=00 OE 

CTHE CORRECT ANSWER!!) 


(A)134551 

Figure 4-5. Patch and Execute Program, Then Verify Results 

processed, and the system and user’s flags are output unless an open reader call is done. After 
the opcode is processed, the program returns to the initial prompt. If the user detects an error 
(in the user’s flag word), it can be cleared either by clearing that word in memory using the MM 
command in the monitor or by taking the E route from the initial prompt. When the user takes 
the E route, only the error flags associated with the punch are cleared; therefore, demonstration 
of error codes must be with respect to the punch. When the punch is opened, the teletypewriter 
echoes back two bells and expects the user to tum-on the punch and press the RUB GUT key. 
Because RUB OUT is not echoed back, it will not appear on the paper tape. 
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4.2.1 DEMONSTRATION PROCEDURE. To perform the assembly of OPTEST, ready the cassette 
by placing the OPTEST source cassette into the cassette 1 transport, rewind the cassette, and press 
the LOAD/FF switch after the cassette has stopped. Also, place a cassette into the cassette 2 trans- 
port to record the assembled object, readying it like the source. The ASR output is shown in 
figure 4-6. Figure 4-7 shows the assembler output. 

4.2.2 LOADING AND OPERATING OPTEST. The general outline for exercising the paper tape 
unit using OPTEST will be (1) to demonstrate the error codes; (2) to examine the output buffer 
for write ASCII and Direct, and to modify the input buffer to compare changes to that buffer 
after the paper tape is read back into memory; (3) to punch paper tape both for ASCII and 
Direct; (4) to read back into memory the paper tape that was produced from (3); and (5) to 
examine the buffer changes that were produced by reading the ASCII paper tape and the Direct 
paper tape. 

To load OPTEST, take the object cassette produced by the assembler, put it into the cassette 1 
transport, and ready the tape as before. Before executing the program, LUNO 9 must be assigned to 
the paper tape reader (PTR) and LUNO A to the paper tape punch (PTP). The ASR output is shown 
in figure 4-8. 

4.2.2. 1 Error Codes. Error code 5 indicates the device is not open, and error code 2 indicates an 
illegal opcode. When the system and user’s flags are output, the rightmost value will be the error 
code and the leftmost value will indicate an error to the monitor. In this sample case, the error 
should be a 4, which is an unrecoverable I/O error to the monitor. For error code 5, try to 
punch tape (BP) before the punch is open, and for error 2, try to read from the punch (9P). 
Note that the teletypewriter interface must be at CRU base 20 16 , which is the left half of 
computer chassis slot 6 at the bottom of the chassis. If a response is not obtained, try turning 
the teletypewriter on and off; or feeding some paper tape through the reader on local; or turn 
the computer off, reseat the interface card, reboot the monitor, and start over from 
paragraph 4.2.2. The ASR output is shown in figure 4-9. 

4.2.2.2 Examine and Modify Buffers. Now look at the monitor output buffer and modify the 
monitor input buffers for read ASCII and Direct by making these two buffers all zeros. The 
output buffer is from 282 to 294; the ASCII input buffer is from 296 to 2A8; and the Direct 
input buffer is from 2AA to 2BE. The IM and MM commands are used to perform these 
operations. The ASR output is shown in figure 4-10. 


(. ASSEMBLE THE DEMONSTRATION PROGRAM) 

■ PA <<CR>> 

PXRASM 948925 ♦♦ 12JUL76 
PREDEFINED REGISTERS? XL <<CR>) 

ASM ••'TERM? A_ <<CR» 

(A) 1 34 5 52 

Figure 4-6. Assemble Demonstration Program 
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PFlGb OOOiS 



0 Ub 0 

— 





0 04 1 

0068 

06 H 0 


BL 

i*7 ES 1 U 1 

PROCESS CHLL 


0 064 

— 





0 048 

0 066 

048 0 


CLR 

9SV3FL 

CLEAR HLL ERR FLAGS 


0 068 

— 





0 043 

UUbH 

i one 

OVER 

JMP 

HbH 1 N 

DD IT AGAIN 

0 044 



■* 




0 045 



♦ OP CDDE PROCtUUKb 


0 04 b 



♦ 




0 04 7 



□PC PRO 

EVEN 




0 038 ♦♦ 1 3 1 b 





0 048 

0 06C 

8FE 0 


XDP 

$ASKUP? 15 

OUTPUT PROMPT 


0 068 

— 





0 049 

0 0 7 0 

8FE 0 


XOP 

9 1 NPL'D ? 15 

GET REPLY 


0 0 78 

— 





0050 

00 74 

B88 0 


MOVE 

S' I NBU8 ? i'VHL 

SET UP FOR CONVERSION 


0076 

— 






0 0 78 

— 





0051 

0 IJ 7 A 

8F EO 


XOP 

i‘UUMBl 9 15 

CONVERT 


0 07C 

— 





0 058 

0078 

06C 0 


SURE 

EO 

PUT IN LEFT BYTE 

0053 

U U8 U 

C OC 0 


MOV 

K 0 ? R3 

GET REPLY VHLUE 

0 U54 

0 088 

0843 


AND1 

R3 ■» > 7 8 0 0 

FIRST REPLY ONLY 


0 084 

7F0 0 





IJU55 

0 086 

C OR 0 


MOV 

■> l 1 MBUh n R8 



0 088 

— 





0 056 

0 OSH 

0848 


HMD I 

ES 9 > 78 

SECOND REPLY ONLY 


0 08 C 

0 0 7F 





0057 

0 088 

0888 


Cl 

R£? >5U 

IS IT PUNCH? 


0090 

0 05 0 





0058 

0 098 

16— 


JNE 

RED 1 83 

NO? CHECK ASCII OR DIRECT 

UU59 

0 094 

D8 0 0 


MOVE 

R o ? i uup 

DEPOSIT RESULTS 


0 096 

— 





0 06 0 

0 098 

Ob HO 


BL 

*' i 88 I U 1 

PROCESS CALL 


0 09 H 

— 





0 061 

0 09 C 

1 0C3 


JMP 

HbH 1 N 

DO IT AGAIN 

0068 



♦ 




U Ub3 



♦ CHEC 

?.K REHE ASCII UR DIRECT 


0064 



♦ 




0 065 



REDTES 

EVEN 




0 098++ 1 6 05 





0066 

0 098 

0888 


Cl 

E8 ? >58 

IS IT READ? 


0 OH 0 

0058 





0 0 b 7 

0 OH 8 

1 6C 0 


JNE 

HbH IN 

NO? BAD START 

0 068 

0 0H4 

0883 


Cl 

R3j .> H 0 0 

IS IT READ DIRECT? 


U UHb 

OH U U 





U Ub9 

0 OHS 

lb — 


JNE 

HR] H'JC 

CHECK READ ASCII 

o o 7 0 

0 OHH 

8FE 0 


XOP 

i'R6DD 1 R !• 15 

PROCESS IT 


0 OAC 

— 





0 07 1 

0 OH 8 

1 ODD 


JNP 

OVER 

DO IT AGAIN 

0078 

0 0B0 

0883 

WR7ASC 

Cl 

R8, > H 0 1 1 

IS IT READ ASCII? 


0 OB 8 

09 0 0 






0 OH 8- 

*♦18 03 





0073 

0 OB 4 

16 — 


JNE 

REDUPN 

IS IT OPEN READER? 

0 0 74 

0 OBb 

8FE 0 


XDP 

•i'REDHi-C ? 15 

PROCESS IT 


(A) 1 34S53 (2/5) 


Figure 4-7. IDT OPTEST (Sheet 2 of 5) 
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PAGE 0003 



0 0£ 8 

— 




0075 

0 OB A 

1 OB 7 


JMP OVER 

BO IT AGAIN 

0076 



♦ 



007 7 

ODBC 

0883 

REBORN 

Cl R3 ? > U 

IS OP COBE OPEN VALUE 


OOBE 

0000 





0 0B4^ 1 6 03 




0 078 

OOCO 

1 6B4 
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Figure 4-9. Error Codes 
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Figure 4-10. Examine and Modify Buffers 
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4.2.2.3 Punch Paper Tape. The program will be executed taking “O” option to the initial 
prompt. Before the user inputs any response to the second prompt, the teletypewriter should be 
placed in local mode, the HERE-IS key for leader/trailer should be pressed twice, and the 
teletypewriter should be placed back in the online mode. The first response to the second 
prompt will be to open the punch (OP). Note that the bell will ring twice alerting the user to 
turn on the punch and press the RUB OUT key. No indication of the RUB OUT will be 
punched on the tape because it is not echoed. The next two responses will be to punch ASCII 
(BP) and to punch Direct (CP). The tape should be similar to figures 4-11 and 4-12. The ASR 
output is shown in figure 4-13. 

Before removing the paper tape just produced, place the TTY in local mode and press the 
HERE-IS key twice to generate several inches of trailer. Opcodes are available which generate 
leader/trailer but are not used in this example. 

4. 2.2.4 Read Paper Tape. The paper tape produced from paragraph 4. 2. 2. 3 is to be used in this 
example. Again, the “O” option should be taken, an open reader (OR) done, a read ASCII (9R) 
done, a read Direct (AR) done, and then the “S” option taken to return to the monitor. The 
ASR output is shown in figure 4-14. 

4.2.2.5 Examine Buffer Change. An examination of what was read off the paper tape and into 
memory, from paragraph 4.2.2.4, will be performed by doing an IM command of the ASCII 
input buffer and the Direct input buffer. The ASR output is shown in figure 4-15. 

The previous exercise read an ASCII tape into a buffer to demonstrate how read ASCII (BP) and 
read Direct works. The user can, for further experimentation, read the Direct tape, using a read 
ASCII (BP). This will demonstrate that certain characters on the Direct tape are not legal ASCII 
values and are ignored in accordance with the file and data formats of Appendix A. 
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Figure 4-1 1 . ASCII Tape 
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Figure 4-12. Direct Tape 
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Figure 4-13. Punch Paper Tape 


0. 

ENTER DESIRED OP-CODE AND MODE CR=REHD? P=PUNCH> 
OR 

INPUT S FOR STOP OR E FDR ERROR PROCEDURE 
OR 0 FOR OP CODE PROCEDURE 
0. 

ENTER DESIRED DP-CODE AND MODE <R=REHD» P=PUNCH> 
9R 
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Figure 4-14. Read Paper Tape 
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US 09 070 A 


(A)l 34559 

Figure 4-15. Exhibit Read ASCII and Direct Buffers, Verify Results 


4.3 SAMPLE PROGRAM 5, BNPF USE WITH PAPER TAPE 

This procedure illustrates use of the BNPF overlay to dump and load data to and from paper 
tape in BNPF format. Since the BNPF utility always dumps to LUNO 7 (normally cassette 
drive 1), reassign LUNO 7 to the paper tape punch for dumps to paper tape or to paper tape 
reader for loads (or compares) from paper tape. See figure 4- 1 6. A reproduction of the resultant 
tape can be seen in figure 4-17. A teletypewriter listing can be seen in figure 4-18. 
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(HERE WE LORD IN THE BNPF OVERLAY) 

. ov, <<cr» 

BB 


M □ W SET UP THE TELETYPE; EE SURE THE INTERFACE CARD IS IN CHASSIS SLDT £0 
IN LIX'AL MODE* PUNCH DUT SOME LEADER ON THE PAPER TAPE BY USING THE 
TELETYPE'S <HERE IS> KEY. THEN PUT THE TELETYPE ON-LINE AND PRESS THE 
PUNCH ON SWITCH. > 


■ ALi.7i.PTP <<CR>> 

. '"THIS IS NECESSARY SINCE 
THE LEFT HAND CASSETTE 


THE BNPF OVERLAY NORMALLY WORKS 
DRIVE) 


OFF 


. MM ? 5 0 0 <<CR>) 


0500=0000 

3 031 

0502=0000 

3233 

0504=0000 

3435 

0506=0000 

3637 

0508=0000 

3839 

05 0 A = 0000 

4243 

05 0C= 0 0 0 0 

444?) 

05 0E= 0 0 0 0 

4647 


< (SPACE BAR> ) 

n 

u 

n 

a 

n 

•i 

<<CR>) 


(WE NOW DUMP THIS AREA OF MEMORY TO PAPER TAPE IN BNPF FORMAT) 

. DB? D ? 5 0 0 ? 5 OF ( < QR> > 

(THE TTY BELL SHOULD RING? WHEN IT DOES ? PRESS THE PUNCH-ON AND THE 
TTY <RUBDUT> KEY TO INITIATE PUNCHOUT) 

(WHEN PUNCHING IS COMPLETE ? PUT THE TTY MOMENTARILY IN LOCAL MODE TO 
PUNCH A TRAILER OF BLANK FRAMES- USE THE <HERE IS> KEY) 

(NOW WE CHANGE THE MEMORY AREA TO SEE IF THE TAPE'S DATA CAN THEN BE 
LOADED BACK IN) 


.MM? 500 ( 

(CR>) 


0500=3031 

FFFF 

< (SPACE 

0502=3233 

FFFF 

n 

0504=3435 

FFFF 

" 

05 06=3637 

FFFF 

a 

0508=3839 

FFFF 

n 

05 0 A =4243 

FFFF 

a 

05 QC=4445 

FFFF 

a 

05 0E=4647 

FFFF 

(<CR>) 


(NOW THE TAPE IS LOADED BACK IN? LUND 7 MUST BE ASSIGNED TO THE 
THE READER? AND THE PAPER TAPE SHOULD BE POSITIONED IN THE READER 
ON THE LEADING BLANK FRAMES.) 

. AL?7?PTR <<CR>) 

. DBi. L 

BEG ADDR=0500 
END ADDR=050F 


(NOW WE CHECK IF THE DATA HAS ACTUALLY LOADED IN) 

. IMi.500i.50F (<CR>) 

0500=3031 3233 3435 3637 >3839 4243 4445 4647 

(SUCCESS! ! ) 

(IF THE USER WISHES? HE CAN LIST THE PAPER TAPE IN LOCAL MODE 
ON THE TELETYPE) 

(A)1 34562 

Figure 4-16. Use of BNPF with Paper Tape 


4-16 Digital Systems Division 



4-17 Digital Systems Division 



BEGINNING 


RECORD 1 
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Figure 4-17. Paper Tape Records, BNPF Format 
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1280 BNNPPNNNNF BNNPPNNNPF BNNPPNNPNF BNNPPNNPPF BNNPPNPNNF BNNPPNPNPF 
1286 BNNPPNPPNF BNNPPNPPPF BNNPPPNNNF BNNPPPNNPF BNPNNNNPNF BNPNNNNPPF 
1292 BNPNNNPNNF BNPNNNPNPF BNPNNNPPNF BNPNNNPPPF 
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Figure 4-18. Teletypewriter Listing 
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APPENDIX A 

PAPER TAPE READER/PUNCH FILE AND DATA FORMATS 


ASR 33 

PERIPHERAL: ASR 33 TTY Paper Tape Reader (ASCII, Direct) 

PHYSICAL ORGANIZATION: Record, File 

END OF RECORD: CR for ASCII, DC3 for Direct 

END OF FILE: DC3 for ASCII, does not apply for Direct 

CHARACTER SET: As shown in figure A-l 

1. HT, FF, BEL, BS, and characters in the range >20 to >7F are stored in the user’s 
buffer. 

2. ETB is translated to CR and stored in the user’s buffer. 

3. CR indicates end of record and is not stored in the user’s buffer. 

4. DC3 received as the first valid character of a record indicates end of file and is not 

placed in the user’s buffer. 

5. The sequence LF, or DEL or LF,DEL or any number of nulls at the beginning of a 

record are ignored if present. The first character following such a sequence is con- 

sidered the first valid character in the record. 

6. In direct mode, the contents of a physical block on tape is transferred to the buffer 
without conversion. 
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Figure A-l. Paper Tape Reader Character Set 
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ASR 33 

PERIPHERAL: ASR 33 TTY Paper Tape Punch (ASCII, Direct) 

PHYSICAL ORGANIZATION: Character, Record, File 
END OF RECORD: Depletion of Character Count 
END OF FILE: DC3 for ASCII, does not apply for Direct 
CHARACTER SET: As shown in figure A-2 

1. HT, FF, BEL, BS, and characters in the range 20 16 to 7F 16 are output as is. 

2. CR in the user’s buffer is translated to ETB and output. 

3. The end of record character sequence is CR, LF, DC3, NULL, NULL, NULL, NULL. 
These characters are automatically output to control the paper tape and are not user 
data characters. 

4. The end of file character sequence is DC3, CR, LF, DC3, NULL, NULL, NULL. 

5. DC3 is allowed within a record for compatibility with standalone software. It may not 
be written, however, as the first data character in the record. 

6. In direct mode: 

• Data is output unconverted; entire ASCII set is valid. 

• The end of record character sequence is DC3, NULL, NULL, NULL. 

• If DC4 is encountered in the user’s buffer, it is output and record is turned on 
again by sending DC2. 

• The user is responsible for ensuring that last block is dumped to cage. 

• The end of record character sequence is output at the end of each write operation 
by the DSR. 
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Figure A-2. Paper Tape Punch Character Set 
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ALPHABETICAL INDEX 
INTRODUCTION 


The following index lists key words and concepts from the subject material of the manual 
together with the area(s) in the manual that supply major coverage of the listed concept. The 
numbers along the right side of the listing reference the following manual areas: 

• Sections - References to Sections of the manual appear as “Section x” with the symbol 
x representing any numeric quantity. 

• Appendixes - References to Appendixes of the manual appear as “Appendix y” with the 
symbol y representing any capital letter. 

• Paragraphs - References to paragraphs of the manual appear as a series of alphanumeric 
or numeric characters punctuated with decimal points. Only the first character of the 
string may be a letter; all subsequent characters are numbers. The first character refers 
to the section or appendix of the manual in which the paragraph is found. 

• Tables - References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number: 

Tx-yy 

• Figures - References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number: 

Fx-yy 

• Other entries in the Index - References to other entries in the index are preceded by 
the word “See” followed by the referenced entry. 
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Absolute Code, PXRATE . . . , . . .2.4, T2-1 
Absolute Format, Compressed ...... 1.2.1 

Addresses, Memory . . . . . . . Fl-1 thru FI -4 
AL Command .............. 3.3 

ASCII Tape .......... . . . . F4-11 

ASCII Format . . F3-2 

Assembler, One-Pass 1.1, 1.4, 4.1.3 

Assign LUNO Command 3.3, 4.2.2, 4.3 

Base Address, CRU 1.2.2, 4.2.2. 1 

Binary to Decimal ASCII Supervisor 

Call ... v 1.2.1 

Binary to Hexadecimal ASCII Supervisor 

Call ...... 1.2.1 

BNPF: 

Dump Sample Program 4.3 

Tape Format F4-17 

TTY Listing F4-18 

Calls, Supervisor 3.1, 3.2, 3.3 

Capabilities, PXRATE Prototyping 

System 1.2.1 

Cassette, Copying from One Tape 

to Another 2.4, 2.4.1, 2.4.2 

Cassette Generation, PXRATE 

Software Tape 2.4, 2.4.1, 2.4.2 

Character Set, 33 ASR 

Reader/Punch Appendix A, 

FA-1, FA-2 

Command: 

AL 3.3 

Assign LUNO 3.3, 4.2.2, 4.3 

Execute User Program Under SIE 

or Trace 4.1.5 

Inspect Buffer .4.1.2, 4.2.2.2 

PA 1.4 

TE 1.4 

Direct Tape F4-12 

Direct Tape Format F3-3 

Error Messages 3.5, T3-3 

Hardware Required .... 1.2.2, Fl-1 thru Fl-4 
Hexadecimal ASCII to Binary 

Supervisor Call 1.2.1 

HIGH/LOW Dump 1.2.1 

Linking Loader 1.1, 1.2, 1.4 

Logical Unit Number 

Assignments 3.3, 4.2.2, 4.3 

LUNOs 3.3, 4.2.2, 4.3 

Memory, Computer 1.2.2 

Memory Requirements for Software .... 1.2.2, 

Fl-1 thru Fl-4 

Messages, Error 4.2.2. 1, T3-3 

Object Code: 

Compressed Absolute Format 1.2.1 


One-Pass Assembler . . . . . . . 1.1, 1.4, 4.1.3 

Overlays . ... . . . . .... 1.1, 1.2.1, 1.4 

2.4, 4.3 

Overlays, Loading of . . .'.■■3,4.4 

PA Command . 1 .4 

Paper Tape Formats . . 3.6.1, F3-2 

Physical Record Block (PRB) . . . . . . . .F3-1 

PROM Programmer 1.2.1, 2.4, T2-1 

Prototyping System, PXRATE: 

Capabilities of . . . . 1.2.1 

Hardware 1.2.2 

Purpose of 1.2 

Software 1.2.1, 1.4 

Publications, Related Preface 

PXRATE .1.1, 1.2, 1.2.1, 1,2.2 

Relocatable Code Version of 

PXRATE 2.4 

Sample Programs .... 4.1 thru 4.3, F4-1 thru 

F4-10, F4-13 thru F4-16 

SIE 4.1.5 

Single Instruction Execution 4.1.5 

Software: 

Memory Requirements for 1.2.2, Fl-1 

thru Fl-4 

Modules . . 1.4 

Prototyping System 1.1, 1.2, 

1.2.1, 1.4 

Source Format, PXRATE 1.2.1 

Supervisor Call: 

Binary to Decimal ASCII . 1.2.1 

Binary to Hexadecimal ASCII 1.2.1 

Decimal ASCII to Binary 1.2.1 

Hexadecimal ASCII to Binary 1.2.1 

Read ASCII 4.2.2.4 

Write ASCII . 4.2.2.3 

Supervisor Calls, I/O 4.2, 4.2.1 

4.2.2 

System Software Tape Cassette 

Generation .2.4, 2.4.1, 2.4.2 

Tape Cassette, Copying from One to 

Another 2.4, 2.4.1, 2.4.2 

Tape Cassette Generation, PXRATE 

Software Tape ....... .2.4, 2.4.1, 2.4.2 

Tape Cassette: 

Installation .F2-3 

Write Tabs F2-2 

TE Command 1.4 

Text Editor 4.1.2 

Text Editor Command .1.4 

Trace, Instruction 4.1.5 

TTY Reader/Punch 1.2, 3.1, 4.3 

Upfront Loader 2.4.1, T2-1 

User Area, Memory .... 1.2.2, Fl-1 thru Fl-4 
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Manual Title: Model 990 Computer Prototyping Monitor (PXRATE) 

System Operation Guide (946243-9701) 
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Please list any discrepancy found in this manual by page, paragraph, figure, or table number in 
the following space. If there are any other suggestions that you wish to make, feel free to 
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